home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 015 / page2.arc / README < prev    next >
Encoding:
Text File  |  1988-06-04  |  6.6 KB  |  141 lines
  1.      ╒══════════════════════════════════════════════════════════════╕
  2.      │                                                              │
  3.      │                      PAGE2  Version 1.0                      │
  4.      │                                                              │
  5.      │  A generic program to print text on both sides of the paper  │
  6.      │                                                              │
  7.      │              by: R. P. Byrne      June 4, 1988               │
  8.      │                                                              │
  9.      ╘══════════════════════════════════════════════════════════════╛
  10.  
  11.    Page2 is a "generic" program for printing on both sides of the paper.
  12.    It is generic in the that no printer initialization or control
  13.    strings are sent by the program to the printer.  You can therefore
  14.    use the program with any printer, laser or dot matrix, so long as any
  15.    special printer settings that may be desired have been programmed by
  16.    you in advance.
  17.  
  18.    Page2 automatically handles embedded formfeed characters,
  19.    overprinting (using either the carriage return with no linefeed
  20.    method or the embedded backspace method) and the expansion of
  21.    embedded horizontal tab characters.
  22.  
  23.    ═════════════════════════════════════════════════════════════════════
  24.  
  25.    The syntax for Page2 is:
  26.  
  27.                  Page2 filename [options] [output filename]
  28.  
  29.    where "filename" specifies the name of the document to be printed,
  30.    and "output filename" is an optional parameter specifying a filename
  31.    to which all printer output should be redirected.
  32.  
  33.    The Page2 program offers several options for the formatting of your
  34.    document each of which is described below:
  35.  
  36.    /W#   -  This parameter informs the Page2 program of the width of the
  37.             printable area of your paper in characters (the # represents
  38.             this number).
  39.  
  40.             e.g.  /W132 tells Page2 that your printer has been set up to
  41.                   print 132 characters per line.
  42.  
  43.             Print lines which contain more than this number of
  44.             characters will be truncated.
  45.  
  46.    /L#   -  This parameter informs the Page2 program of the length of
  47.             the printable area of your paper in lines (the # represents
  48.             this number).
  49.  
  50.             e.g.  /L60 tells Page2 that your printer has been set up to
  51.                   print 60 lines per page.
  52.  
  53.    /M#   -  Ths parameter specifies the width (in characters) of an
  54.             optional 'gutter' margin.  A 'gutter' margin (sometimes
  55.             called a 'binding' margin) is one that prints on the left
  56.             side of odd numbered pages and on the right side of even
  57.             numbered pages. This is especially useful if you wish to
  58.             insert your printed document into a 3-ring binder or if you
  59.             intend to staple all of the pages together to give the
  60.             appearance of a book.
  61.  
  62.             Note that the number of characters specified here is
  63.             automatically deducted by the program from the page width
  64.             specified with the /W# parameter, effectively reducing the
  65.             number of characters that may be printed on each line.
  66.  
  67.    /F    -  This parameter toggles the printing of formfeed characters
  68.             at the end of every page.  This is only useful if
  69.             you decide to leave room at the bottom of your page (a
  70.             bottom margin) by specifying a page length (via the /L
  71.             option) that is less than the physical length of your paper.
  72.  
  73.    /E    -  This parameter toggles the "which pages get printed first"
  74.             flag in the program (ie. even pages first, or odd).
  75.  
  76.    /N, /P, /D  - These parameters toggle the printing of certain
  77.             information for running page headers.
  78.  
  79.             /N toggles the printing of the filename of your text file in
  80.             the header, /P toggles the printing of page numbers, and /D
  81.             toggles the printing of the current date.  If all three
  82.             parameters are toggled OFF, no running header will be
  83.             produced.
  84.  
  85.    The default settings for all program options may be customized by the
  86.    user through the Page2Cfg program.  As shipped, the defaults are:
  87.  
  88.         Page Width = 80 characters
  89.         Page Length = 66 lines
  90.         Gutter Margin = 0 characters (ie. no margins)
  91.         No Formfeeds issued between pages
  92.         Odd pages printed first
  93.         No running headers produced
  94.  
  95.    While these "factory" default settings will produce acceptable
  96.    results on most printers, there will always be those who would want
  97.    them changed.  You may, for instance, decide that you want, by
  98.    default, to have a full running header printed for each document.
  99.  
  100.    The Page2Cfg program allows this customization to take place.  Simply
  101.    place both the Page2 and Page2Cfg programs into the same
  102.    subdirectory, invoke the Page2Cfg program, and follow the prompts.
  103.  
  104.    ═════════════════════════════════════════════════════════════════════
  105.  
  106.    Should you find any bugs in the program (God forbid ...) or have any
  107.    suggestions for additional functionality, you can reach the author by
  108.    leaving an electronic mail message for Richard Byrne on any of the
  109.    fine electonic bulletin board systems listed below:
  110.  
  111.             Software Society            Software Society South
  112.             Sysop: Paul Kopit           Sysop: Dave Klein
  113.             (201) 729-7410              (201) 214-8896
  114.  
  115.             Sparta PCBoard              Chuck's Attempt
  116.             Sysop: Richard Driggers     Sysop: Chuck Ammann
  117.             (201) 729-5377              (201) 729-2602
  118.  
  119.             Computer Connections        Northern Lights
  120.             Sysop: Robert Blacher       Sysop: Jack Kilday
  121.             (202) 547-2008              (207) 766-2467
  122.  
  123.    ═════════════════════════════════════════════════════════════════════
  124.  
  125.    I have placed these programs and their source code into the public
  126.    domain in the hopes that they may prove useful to someone other
  127.    then myself.
  128.  
  129.    Please feel free to distribute these programs by any means available.
  130.    I only ask, as a courtesy, that the programs not be distributed
  131.    without the inclusion of the source code and the documentation file.
  132.  
  133.    Since these programs are truly public domain software, if you paid
  134.    someone more than $5.00 to receive them, you've probably been ripped
  135.    off.
  136.  
  137.                                                         rpb
  138.                                                        6/4/88
  139.  
  140.    ═════════════════════════════════════════════════════════════════════
  141.